<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
	<head>
		<meta http-equiv="Content-type" content="text/html; charset=UTF-8" />
		<title>Appearance Preferences &mdash; Intype Documentation</title>
		<link rel="stylesheet" href="css/static.css" type="text/css" />
		<link rel="stylesheet" href="css/content.css" type="text/css" />
	</head>
	<body>
		<div id="page"><div id="page-inner">

			<div id="sub-header"><div id="sub-header-inner">
				&nbsp;
			</div></div>

			<div id="cols">

				<div id="nav">
					<div id="nav-inner">
						<h1>Manual</h1>
						<ul>
							<li><a href="introduction.html" class="title"><span>Introduction</span></a></li>
							<li><a href="editing.html" class="title"><span>Editing</span></a>
							<ul>
								<li><a href="selections.html" class="title"><span>Selections</span></a></li>
								<li><a href="find_and_replace.html" class="title"><span>Find & Replace</span></a></li>
							</ul>
							</li>
							<li><a href="preferences.html" class="title"><span>Preferences</span></a>
							<ul>
								<li><a href="appearance_preferences.html" class="title"><span>Appearance Preferences</span></a></li>
							</ul>
							</li>
							
							<li><a href="scopes.html" class="title"><span>Scopes</span></a>
							<ul>
								<li><a href="document_scopes.html" class="title"><span>Document Scopes</span></a></li>
								<li><a href="application_scopes.html" class="title"><span>Application Scopes</span></a></li>
								<li><a href="scope_selectors.html" class="title"><span>Scopes Selectors</span></a></li>
								<li><a href="scope_naming_conventions.html" class="title"><span>Naming Conventions</span></a></li>
							</ul>
							</li>
							
							<li><a href="bundles.html" class="title"><span>Bundles</span></a>
							<ul>
								<li><a href="bundle_items.html" class="title"><span>Bundle Items</span></a></li>
								<li><a href="scopes.html" class="title"><span>Scopes</span></a></li>
								<li><a href="snippets.html" class="title"><span>Snippets</span></a></li>
								<li><a href="languages.html" class="title"><span>Languages</span></a></li>
								<li><a href="built_in_bundles.html" class="title"><span>Built-In Bundles</span></a></li>
							</ul>
							</li>
							<li><span class="title missing"><span>appendix</span></span>
							<ul>
								<li><a href="jasmine.html" class="title"><span>Jasmine</span></a></li>
								<li><a href="regular_expressions.html" class="title"><span>Regular Expressions</span></a></li>
							</ul>
							</li>
						</ul>
					</div>
				</div>

				<div id="content">
					<div id="content-right">
						<div id="content-left">
							<div id="content-inner">
								<h1>Appearance Preferences</h1>

<p>Appearance preferences for editor are stored in presets. Each preset can have list of language selectors. When you open a file, Intype will automatically pick the best matching preset and set it for you. This way you can use centered layout only for documents (Textile, Markdown, etc.), different word-wrap settings for HTML files and source code files, etc.</p>

<p><img src="img/preferences_dialog.png" alt="preferences_dialog.png"/></p>

<p>Presets predefined (1) in standard installation include:</p>

<ul>
<li><strong>Code preset</strong> that is optimized for all source.* languages. The wrapping is turned off, and the indentation chars are enabled only at line's start and breaking of whitespace is turned on.</li>
<li><strong>Document preset</strong> is optimized for editing documents like Textile, Markdown, etc. It is using centered layout with width of 120 characters. Break whitespace is turned off.</li>
<li><strong>HTML, XHTML, XML preset</strong> is set to break at window's end with no boundary set. All indentation characters are rendered.</li>
</ul>

<p>Feel free to add (2), remove (4) or rename (3) the presets defined in standard installation to meet your needs.</p>

<p>To set selectors use <strong>Apply preset to these languages</strong> text field (5). Use a comma-separated list of language names (stored in grammar file). Note that this is not exact name match, but rather a wildcard match. So you can define <code>text</code> as a selector and it will match <code>text.html</code>, <code>text.html.strict</code>. However with lower priority than <code>text.html</code>. The more "characters" from selector are matched, the higher priority the preset gets.</p>

<p>Checkbox <strong>Default</strong> (6) tells Intype to use the preset when no other matches the language. There always has to be at least one default preset.</p>

<h2>Word wrap preferences</h2>

<p><img src="img/word_wrap_options.png" alt="word<em>wrap</em>options.png"/></p>

<p>Word wrap preferences allows you to customize the text layout and rendering. You can:</p>

<ul>
<li>Use dynamic breaking at window boundary, or fixed (2) custom boundary (set in average character units).</li>
<li>Align wrapped lines to base line's indentation (4).</li>
<li>Show or hide the wrapping boundary (1), wrapping markers (5) or indentation characters (7)(8)(9).</li>
</ul>

<h2>Boundary</h2>

<p><img src="img/word-wrap_r2_c2.png" alt="word-wrap_r2_c2.png"/></p>

<p><strong>Show boundary</strong> checkbox will add a boundary to the editor (1). You can then decide whether to break at boundary or not.</p>

<h2>Automatic breaking at boundary</h2>

<p><img src="img/word-wrap_r2_c2_f2.png" alt="word-wrap<em>r2_c2</em>f2.png"/></p>

<p>If <strong>Break at boundary</strong> is checked, then the breaking is done at the boundary specified in the text box above, otherwise the breaking is done at window boundary (see illustration below). Intype supports two types of handling whitespace at the break boundary. <strong>Break whitespace</strong> is used mostly for editing source code (see illustration below).</p>

<p><img src="img/word-wrap_r2_c2_f3.png" alt="word-wrap<em>r2_c2</em>f3.png"/></p>

<p>Unchecking this <strong>Break whitespace</strong> checkbox will result in leaving the whitespace at the end of the line -- even if it flows over the boundary, or window. This is standard for editing documents.</p>

<h2>Aligning wrapped lines</h2>

<p><img src="img/word-wrap_r2_c2_f4.png" alt="word-wrap<em>r2_c2</em>f4.png"/></p>

<p>For keeping wrapped lines more readable, you can use <strong>Align wrapped lines</strong> checkbox. Wrapped lines are then aligned with indentation space at the beginning of physical line.</p>

<p><img src="img/word-wrap_r2_c2_f5.png" alt="word-wrap<em>r2_c2</em>f5.png"/></p>

<p><strong>Show wrapping marker</strong> will show guideline at the left of the wrapped lines.</p>

<h2>Centerred layout</h2>

<p><img src="img/word-wrap_r2_c2_f6.png" alt="word-wrap<em>r2_c2</em>f6.png"/></p>

<p><strong>Center document</strong> turns on document-like editing rendering. Text area is centered to the editor and wrapped by width specified in the boundary text box. This option is only available together with <strong>Break at boundary</strong> option.</p>

<h2>Indentation characters</h2>

<p><img src="img/word-wrap_r2_c2_f7.png" alt="word-wrap<em>r2_c2</em>f7.png"/></p>

<p><strong>Indentation characters</strong> are rendered in three regions on the line: before line's text (7), in line's text (8) and after line's text (9).</p>

<ol>
<li><strong>Line start</strong> will render spaces and tabs only at the beginning of line.</li>
<li><strong>Line text</strong> will render spaces and tabs only between words and text on line.</li>
<li><strong>Line end</strong> will render spaces and tabs only after line's text or on empty line.</li>
</ol>
							</div>
						</div>
					</div>
				</div>

			</div>

		</div>

		</div>
	</body>
</html>